home *** CD-ROM | disk | FTP | other *** search
/ Assassins - Ultimate CD Games Collection 2 / Assassins 2 - Ultimate Games No. 2 (1995)(Weird Science)[!][Amiga-CD32-CDTV].iso / disks / print1.dms / print1.adf / MDSpool / MDSpool.doc.pp / MDSpool.doc
Text File  |  1990-09-13  |  53KB  |  1,585 lines

  1. zq(Bpwv"z
  2.  
  3.  
  4.                                                          Introduction 1
  5.  
  6.  
  7.  
  8.                    MegaD Spool 1.2 © Copyright 1993 John L. Jones
  9.  
  10.                                      Written by:
  11.  
  12.                                     John L. Jones
  13.                                      PO Box 292
  14.                                  Midvale, Utah 84047
  15.                                          USA
  16.  
  17.  
  18.  
  19.  
  20.  
  21.           Introduction......................................2
  22.           DISCLAIMER........................................4
  23.           Control Window....................................6
  24.           MegaD Spool Settings..............................10
  25.           MegaD Spool Menu..................................16
  26.           MegaD Spool Icon tools type.......................17
  27.           ARexx commands....................................18
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                    MegaD Spool 1.2 © Copyright 1993 John L. Jones
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                                          Introduction 2
  71.  
  72.  
  73.                                        Introduction
  74.  
  75.                     MegaD Spool Is to complement MegaDs print
  76.                     capabilities.  MegaD is a "Directory Utility," it
  77.                     will create and spool print task to the printer
  78.                     but it allows very little control over the task
  79.                     created.  MegaD Spool is a semi-smart print spool
  80.                     that will try to do its best to create the desired
  81.                     results as set by the "Settings" area of MegaD
  82.                     Spool.  It also maintains a list of pending jobs
  83.                     to be printed and allows the user to manipulate or
  84.                     remove those jobs.
  85.  
  86.                     If you are unaware of MegaD and what MegaD is or
  87.                     what it could do for you:
  88.  
  89.                     MegaD, is without question, a unique directory
  90.                     utility.  It does not play by the old rules set by
  91.                     the gambit of directory utilities.
  92.  
  93.                     The standard directory utility allows only one
  94.                     source directory and one destination directory and
  95.                     usually places the two available directories in
  96.                     list side by side.  MegaD can emulate this type of
  97.                     mode if you need but this limited mode of left and
  98.                     right directory windows restricts many of the
  99.                     unique features of MegaD.  Features such as the
  100.                     ability to copy files from more than one source
  101.                     directory, the ability to copy source files to
  102.                     multiple destinations.  The ability to copy from
  103.                     multiple source to multiple destinations.  The
  104.                     same flexibility is given to all the commands
  105.                     within MegaD, commands such as Copy As, Duplicate,
  106.                     Move, Move as, Rename, Delete, Comments, Set
  107.                     Protect....
  108.  
  109.                     This idea of not being restricted to just one or
  110.                     two windows is used throughout MegaD.  You are
  111.                     allowed multiple text windows open at one time.
  112.                     The only thing that will limit you with MegaD is
  113.                     your available system memory.
  114.  
  115.                     So if you haven't tried MegaD, you really should.
  116.                     The rest of this document will describe how to use
  117.                     MegaD Spool.
  118.  
  119.           Any inquires, please write:
  120.                     John L. Jones
  121.                     PO Box 292
  122.                     Midvale, Utah 84047
  123.                     USA
  124.  
  125.  
  126.                    MegaD Spool 1.2 © Copyright 1993 John L. Jones
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                                          Introduction 3
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.                    MegaD Spool 1.2 © Copyright 1993 John L. Jones
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                                          Introduction 4
  203.  
  204.  
  205.  
  206.  
  207.                                        v"zDISCLAIMERv"z
  208.  
  209.                No warranties are implied or expressed with regard to the
  210.                fitness or merchantability of MegaD Spool for any
  211.                particular purpose.  All risks and damages, incidental or
  212.                otherwise, arising through  the use or misuse of MegaD
  213.                Spool are entirely at the responsibility of the user.
  214.  
  215.                While considerable effort has been made to provide you with
  216.                a reliable product, there is no guarantee that this program
  217.                is 100% "bug-free".  Any problems that do arise will be
  218.                corrected when and if feasible.  Maintenance releases will
  219.                be made available in order to correct potentially hazardous
  220.                malfunctions within the program.  Fixes for benign
  221.                problems, usually cosmetic in nature, will most likely be
  222.                deferred until the next major release of MegaD Spool.  This
  223.                disclaimer does not guarantee future versions of this
  224.                product, only a prescribed method of dealing with possible
  225.                errors, and their corrections, to this program.
  226.  
  227.                                       v"zDistribution v"z
  228.                MegaD Spool is freely distributable as long as all of the
  229.                following conditions  are met:
  230.  
  231.                Permission is granted to make and distribute verbatim
  232.                copies of this manual provided the copyright notice and
  233.                this permission notice are preserved on all copies.
  234.  
  235.                No guarantee of any kind is given that the programs
  236.                described in this document are 100% reliable. You are using
  237.                this material at your own risk. The author *can not* be
  238.                made responsible for any damage which is caused by using
  239.                these programs.
  240.  
  241.                This package is freely distributable, but still copyright
  242.                by John L. Jones. This means that you can copy it freely as
  243.                long as you don't ask for a more than nominal copying fee.
  244.                This fee *must not* be more than US $5.
  245.  
  246.                Permission is granted to include this package in Public-
  247.                Domain collections, especially in Fred Fishs Amiga Disk
  248.                Library (including CD ROM versions of it). The distribution
  249.                file may be uploaded to Bulletin Board Systems or FTP
  250.                servers. If you want to distribute this program you *must*
  251.                use the original distribution archives
  252.  
  253.                None of the programs nor the source code (nor parts of it)
  254.                may be included or used in commercial programs unless by
  255.                written permission from the author.
  256.  
  257.  
  258.                    MegaD Spool 1.2 © Copyright 1993 John L. Jones
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                                                          Introduction 5
  269.  
  270.  
  271.  
  272.                All copyright notices must remain unaltered.
  273.  
  274.                MegaD Spool may not appear on any electronic agency which
  275.                charges more than the basic access fee to down-load MegaD
  276.                Spool.
  277.  
  278.                MegaD Spool may not appear on any electronic agency that
  279.                claims copyrights to uploaded programs, either alone or as
  280.                part of a collection.
  281.  
  282.                MegaD Spool may not be sold commercially alone or as a
  283.                element in another product.
  284.  
  285.                If you would like a variance to any of the above
  286.                conditions, please contact me.
  287.  
  288.  
  289.                John L. Jones
  290.                PO Box 292
  291.                Midvale, Utah 84047
  292.                USA
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.                    MegaD Spool 1.2 © Copyright 1993 John L. Jones
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.                                            MegaD Spool Control Window 6
  335.  
  336.  
  337.           v"zMegaD Spool Windowsv"z
  338.                     MegaD Spool Works from two windows,  the first
  339.                     window that MegaD Spool opens is the control
  340.                     window and a second window is available by
  341.                     selecting the "Settings..." gadget in the control
  342.                     window.
  343.  
  344.  
  345.           v"zControl Windowv"z
  346.  
  347.                     The control window has three sections of gadgets.
  348.  
  349.                     The top section is to control the current task
  350.                     being sent to the printer.  It contains the
  351.                     "Current Job" display, the "Pause Print" check box
  352.                     gadget and the "Stop Current Job" gadget.
  353.  
  354.                     The center section of gadgets gives you control
  355.                     over what file you wish to print and allows you to
  356.                     select, remove or modify the print jobs waiting to
  357.                     go to the printer.  It contains the "Pending Jobs"
  358.                     list, the "Remove Selected Job" gadget, the
  359.                     "Remove All" Jobs Gadgets, the "Add Job" gadget
  360.                     and the "Modify Job" gadget.
  361.  
  362.                     The lower section of the window contains a few
  363.                     major control gadgets that let you define how
  364.                     MegaD Spool prints files, iconifies the program
  365.                     and quits the program.  It contains the gadgets
  366.                     "Settings...", "Iconify", and "Quit"
  367.  
  368.           v"zApplication Windowv"z
  369.                     The Control Window is a "Workbench Application
  370.                     Window" while it is on the Workbench screen.  This
  371.                     means that you may pick up icons from the
  372.                     Workbench windows and drop then onto the MegaD
  373.                     Spool window.  This will give you the same results
  374.                     as using the "Add Job..." gadget and selecting
  375.                     that file from the file requestor.
  376.  
  377.           v"zCurrent Jobv"z
  378.                     This is a text area.  It displays the current
  379.                     print job going to the printer.  It displays only
  380.                     the file name of the job not the path of the file.
  381.                     If there is not a current job the area will be
  382.                     blank.
  383.  
  384.           v"zPause Printv"z
  385.                     This is a check box gadget.  While this gadget is
  386.                     checked, MegaD Spool will not send information to
  387.                     the printer.  Do not expect the printer to stop
  388.  
  389.  
  390.                    MegaD Spool 1.2 © Copyright 1993 John L. Jones
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.                                            MegaD Spool Control Window 7
  401.  
  402.  
  403.                     just because you have checked this box.  Most
  404.                     printers have a buffer that stores the text being
  405.                     sent to the printer.  The printer will not stop
  406.                     until the information in the buffer gets printed.
  407.                     This gadget  toggles by pressing the Escape key or
  408.                     pressing the 'P' key on the keyboard.  If you
  409.                     check this gadget before adding a job, the job
  410.                     will be held until you uncheck the gadget.  This
  411.                     is convenient for modifying and setting different
  412.                     settings for each job.  This will be explained
  413.                     more during the explanation of the "Modify Job"
  414.                     gadget.
  415.  
  416.           v"zAdd Jobv"z
  417.                     This gadget will open a file requestor so that you
  418.                     may select the file you wish to send to the
  419.                     printer.   If you should select a file it will
  420.                     first be added to the job list and then if there
  421.                     are no current jobs and the "Pause Print" gadget
  422.                     is not checked, that job will be send to the
  423.                     printer.  The file requestor is the standard ASL
  424.                     file requestor so you should be familiar with its
  425.                     workings.
  426.  
  427.           v"zRemove All Jobsv"z
  428.                     This gadget is ghosted when there are not any jobs
  429.                     pending in the job list.  Once a job is in the
  430.                     list it will become unghosted and you may use it.
  431.                     It will remove all jobs in the job list and it
  432.                     will check to see if you want to cancel the
  433.                     current job going to the printer.  Before it takes
  434.                     each step it will open a system requestor asking
  435.                     if you are sure that you want to do this.
  436.  
  437.           v"zRemove Selected Jobv"z
  438.                     This gadget will be ghosted if there is not a
  439.                     selected job in the list.  At the bottom of the
  440.                     "Pending Jobs" is a display area the will be blank
  441.                     or it will display a selected job from the list.
  442.                     If there is a job being displayed in this area you
  443.                     may remove this job by selecting the "Remove
  444.                     Selected Job".  You will not be warned that you
  445.                     are removing the job as you were with "Remove All
  446.                     Jobs".
  447.  
  448.           v"zModify Jobv"z
  449.                     This gadget will be ghosted if there is not a
  450.                     selected job in the pending job list.  If there is
  451.                     a selected job you will be able to modify the
  452.                     specifications for that job only.  This will not
  453.                     affect the other jobs in the list or the current
  454.  
  455.  
  456.                    MegaD Spool 1.2 © Copyright 1993 John L. Jones
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.                                            MegaD Spool Control Window 8
  467.  
  468.  
  469.                     settings of MegaD Spool.  MegaD Spool will open
  470.                     the Settings window to allow you to modify each
  471.                     aspect of the print job.  The settings area will
  472.                     be explained latter on in the section describing
  473.                     the "Settings Window".
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.                    MegaD Spool 1.2 © Copyright 1993 John L. Jones
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.                                            MegaD Spool Control Window 9
  533.  
  534.  
  535.           v"zIconifyv"z
  536.                     By selecting this gadget MegaD Spool will close
  537.                     the control window and place a small icon on the
  538.                     Workbench.  This is called an "Application Icon"
  539.                     and will let you drop file icons from the
  540.                     Workbench window onto this icon.  The step of
  541.                     dropping a file icon onto MegaD Spool application
  542.                     icon is the same as adding a job with the "Add
  543.                     Job" gadget.  While MegaD Spool is iconified there
  544.                     is no way to pause the job from going to the
  545.                     printer.  If Pause Print was checked before you
  546.                     selected "Iconify",  the job  will be no longer be
  547.                     paused and sent to the printer.
  548.  
  549.           v"zMegaD Spool Settingsv"z
  550.                     This will open a window with several gadgets to
  551.                     let you set the default settings of MegaD Spool.
  552.                     This is explained in the next section.
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.                    MegaD Spool 1.2 © Copyright 1993 John L. Jones
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.                                                 MegaD Spool Settings 10
  599.  
  600.  
  601.                                    v"zMegaD Spool Settingsv"z
  602.  
  603.                     Once the Settings window is opened by the
  604.                     "Settings" gadget from the control window the
  605.                     MegaD Spool Settings window will open.  This
  606.                     window is divided into a few sections.  All
  607.                     attributes here specify just how MegaD Spool
  608.                     handles print jobs. 
  609.  
  610.                     The settings done here work with your preference's
  611.                     settings that were set by the printer preferences
  612.                     of the Workbench.  This is important to remember
  613.                     strange things may happen if some of the settings
  614.                     conflict with MegaD Spool settings.  A couple of
  615.                     examples of these types of conflicts:
  616.  
  617.                     If you set your Workbench Printer Preferences to
  618.                     Elite pitch the "Normal Pitch" setting of MegaD
  619.                     Spool will be Elite.
  620.  
  621.                     If your Page Width is greater than the page width
  622.                     as set by your Workbench Printer Preferences you
  623.                     will get unwanted print wraps from oversize lines.
  624.                     You can calculate your Workbench Printer
  625.                     Preferences page width with this formula,
  626.  
  627.                     Right Margin - Left Margin = Page Width
  628.  
  629.                     I set my Workbench Printer Preferences Right
  630.                     Margin to 80 and my Left Margin to 0.  This allows
  631.                     a full 80 character page width. (80 - 0 = 80)
  632.  
  633.                     If strange things are happening and you cannot
  634.                     figure out what is going on, check out your
  635.                     Workbench Printer Preferences to see if the
  636.                     problems may be due to conflicting settings.
  637.  
  638.           v"zPitch settingsv"z
  639.                     The pitch settings is a set of "Radio" type
  640.                     buttons.  You press on one and the others in the
  641.                     set pop out.  You are given four choices for you
  642.                     print pitch. They are:
  643.                          Normal    (10 characters per inch)
  644.                          Elite     (12 characters per inch)
  645.                          Condensed (15-17 characters per inch)
  646.                          NLQ       (10 characters per inch)
  647.                     By selecting a smaller pitch, such as Elite, you
  648.                     are able to print 96 characters across a page
  649.                     instead of only 80 characters, this is good to
  650.                     know so that you can change the "Page Width"
  651.                     settings.
  652.  
  653.  
  654.                    MegaD Spool 1.2 © Copyright 1993 John L. Jones
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.                                                 MegaD Spool Settings 11
  665.  
  666.  
  667.  
  668.           v"zLine spacingv"z
  669.                     This is another set of radio control buttons.  You
  670.                     are able to select from one of two settings.
  671.                          1/6" Lines (6 lines per inch)
  672.                          1/8" Lines (8 lines per inch)
  673.                     With this we can change how many lines of text
  674.                     will fit on one page.  If you are using standard
  675.                     11" long paper you will be able to get 66 lines
  676.                     per page by using "1/6" Lines" settings or you
  677.                     could get 88 lines on a page by using "1/8" Lines"
  678.                     settings.
  679.  
  680.           v"zPage Widthv"z
  681.                     This is an integer input gadget.  It will allow
  682.                     you to enter a numeric value.  This value should
  683.                     represent the total width of the paper you will be
  684.                     printing to as computed by the pitch selection.
  685.                     As an example of this,  should you have selected
  686.                     Elite as a pitch, you should change the value in
  687.                     this string gadget to 96.
  688.  
  689.           v"zLeft Marginv"z
  690.                     This is the column that you want your text to
  691.                     start on.
  692.  
  693.           v"zRight Marginv"z
  694.                     This is the number of columns from the right side
  695.                     of your page width settings that you want to end
  696.                     the line.  The text will word wrap to the next
  697.                     line if it exceeds the left margin.
  698.  
  699.           v"zBinding Widthv"z
  700.                     This is a special setting that is intended to help
  701.                     you print your document with enough of a left
  702.                     margin that you can place the printed paper into a
  703.                     binder without worrying about punching holes
  704.                     through the text.  There are some special
  705.                     considerations on how the binding width is added
  706.                     to the first of the printed line.  This will be
  707.                     covered during the "Mode" description.
  708.  
  709.           v"zCalculating Text Widthv"z
  710.                     The formula for calculating text width (the
  711.                     maximum width of one line of text) is:
  712.  
  713.                          Page Width - Left Margin - Right Margin -
  714.                               Binding Width = Printed Text Width.
  715.  
  716.           v"zTab Widthv"z
  717.                     This is the width that each tab is worth as
  718.  
  719.  
  720.                    MegaD Spool 1.2 © Copyright 1993 John L. Jones
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.                                                 MegaD Spool Settings 12
  731.  
  732.  
  733.                     spaces.  A standard printed tab is 8 characters
  734.                     wide but you may adjust this to your liking.  This
  735.                     is ignored on 'Pass Through Mode'.
  736.  
  737.           v"zPage Lengthv"z
  738.                     This is the number of lines that will fit on one
  739.                     printed page.  
  740.  
  741.  
  742.           v"zTop Marginv"z
  743.                     This is the number of blank lines to print before
  744.                     the first line of text is printed.
  745.  
  746.           v"zBottom Marginv"z
  747.                     This is the number of blank lines to print before
  748.                     the end of the page.
  749.  
  750.           v"zPrint Pathv"z
  751.                     This is a cycle gadget that has Three settings,
  752.                     "No Path", "In Heading" and "In Footer".  If "In
  753.                     Heading" or "In Footer" is selected, the path and
  754.                     file name will be printed on each page.  This line
  755.                     is printed just after the top margin or just
  756.                     before the bottom margin.  One more blank line
  757.                     will be printed to separate the printed path from
  758.                     the text of the document.
  759.  
  760.           v"zPrint Page Numberv"z
  761.                     This is a cycle gadget that has seven possible
  762.                     settings, "No Number", "LH Top", "Center Top", "RH
  763.                     Top", "LH Bottom", "Center Bottom",  and "RH
  764.                     Bottom".  All settings except for "No Number" will
  765.                     place a page number on the printed page.  RH
  766.                     refers to Right Hand and LH refers to Left Hand.
  767.                     The format of the number is "Page #".
  768.  
  769.           v"zModev"z
  770.                     This is a cycle gadget that can be set to three
  771.                     different settings.  Pass Through, Smart, and
  772.                     Reformat.  Each mode has its own individuality and
  773.                     will be discussed as its own subject.
  774.            
  775.           v"zMode, Pass Throughv"z
  776.                     This is the simplest of the three modes.  It
  777.                     ignores the settings attributes.  It will send the
  778.                     file straight to the printer without any
  779.                     modifications.  What is in the file will be sent
  780.                     to the printer.  This is a good time to bring up a
  781.                     special point.  Just because the spooler sent it
  782.                     does not mean that the printer received it.  The
  783.                     Amiga printer driver determines what the printer
  784.  
  785.  
  786.                    MegaD Spool 1.2 © Copyright 1993 John L. Jones
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.                                                 MegaD Spool Settings 13
  797.  
  798.  
  799.                     gets.  It is designed to translate a file to the
  800.                     selected printer.  It is one of the attractive
  801.                     things about the Amiga computer system.  Should
  802.                     strange characters show up in your document, it
  803.                     might be due the file not being compatible with
  804.                     the Amiga standard print commands.
  805.  
  806.           v"zMode, Reformatv"z
  807.                     The Reformat mode does just that.  It will remove
  808.                     the extra spaces, tabs, line feeds, form feeds and
  809.                     any escape sequences. It will then start to
  810.                     reformat the document to the current settings.
  811.                     This works fine for some jobs but it will totally
  812.                     botch up other jobs.  The jobs that it will botch
  813.                     up are jobs that the original document file
  814.                     contains its own headings, footers, page numbers
  815.                     and indented paragraphs.  If the original document
  816.                     has formatted tables of nicely formatted rows and
  817.                     columns,  they will not be in that format once the
  818.                     it is reformatted.  What happens to this
  819.                     information is it will become embedded into the
  820.                     regular flow of the paragraphs of the document.
  821.  
  822.           v"zMode, Smartv"z
  823.                     This mode v"zTRIESv"z to be smart.  Notice the heavy
  824.                     emphasis on tries.  MegaD Spool will look for
  825.                     command formatted attributes in the document to be
  826.                     printed.  MegaD Spool displays these attributes
  827.                     with each job once the job is added to MegaD
  828.                     Spool.  The attributes are displayed with the file
  829.                     name on the right edge of the list.  The
  830.                     attributes are displayed as capital letters.  Each
  831.                     letter represents a file attribute. This is what
  832.                     the letters mean:
  833.  
  834.                     A
  835.                               This file consists of ASCII printable
  836.                               characters.  This means that the file
  837.                               contains characters that can be sent to
  838.                               the printer as they are and no special
  839.                               conversion done.  If the file contains
  840.                               other than ASCII characters the file
  841.                               will be considered a HEX file and
  842.                               printed that way, HEX will be explained
  843.                               in the H attribute section.
  844.  
  845.                     F
  846.                               This file has lines Formatted within the
  847.                               standard 80 character line.  Should your
  848.                               "Page Width" setting be greater than 80,
  849.                               MegaD Spool will use the greater number
  850.  
  851.  
  852.                    MegaD Spool 1.2 © Copyright 1993 John L. Jones
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.                                                 MegaD Spool Settings 14
  863.  
  864.  
  865.                               as the gauge to tell if the lines are
  866.                               formatted to that width.  If the lines
  867.                               are formatted, MegaD Spool will not
  868.                               modify the line.  It will not change the
  869.                               left margin to match the "Left Margin"
  870.                               settings.  Should you want to move the
  871.                               left margin further to the right of the
  872.                               printed page, uses the "Binding Width"
  873.                               setting to do so.
  874.  
  875.                               Using "Binding Width" on a formatted
  876.                               line can cause some trouble.  If you are
  877.                               working with an 80 column printer line
  878.                               and the formatted line is 75 characters
  879.                               long and the you add a 10 character
  880.                               binding width, you will end up with an
  881.                               85 character line.  This 85 character
  882.                               line will force an unwanted line on the
  883.                               printed page.  MegaD Spool will not know
  884.                               of this extra line and place the top and
  885.                               bottom margins one line further down the
  886.                               page.  Each time this happens the page
  887.                               breaks will be placed further and
  888.                               further out of sink with the
  889.                               perforations of the printed paper. If
  890.                               this is a problem, use a smaller pitch
  891.                               to let the binding width and the
  892.                               formatted line work.
  893.  
  894.                               Note: Setting the pitch to Elite or
  895.                               Condensed and changing the page width
  896.                               accordingly is useful for printing C
  897.                               source code that usually has longer than
  898.                               normal lines in the code.  As long as
  899.                               the lines in the source code are shorter
  900.                               than the "Page Width" setting MegaD
  901.                               Spool will not reformat the printed
  902.                               lines.  It will just add page breaks,
  903.                               headers and footers if required.
  904.  
  905.                     P
  906.                               The P attribute stands for Page Breaks.
  907.                               MegaD Spool has found form feeds
  908.                               characters in the document.
  909.  
  910.                     FP
  911.                               If MegaD Spool finds both (F) formatted
  912.                               lines and (P) page breaks it will come
  913.                               to the conclusion that this is a fully
  914.                               formatted document and should not try to
  915.                               do any reformatting or page breaks.  It
  916.  
  917.  
  918.                    MegaD Spool 1.2 © Copyright 1993 John L. Jones
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.                                                 MegaD Spool Settings 15
  929.  
  930.  
  931.                               will send each line to the printer as it
  932.                               was found in the file.  It will however
  933.                               respect the "Binding Width" setting.  If
  934.                               you set the "Binding Width" to anything
  935.                               other than 0 please refer to the short
  936.                               discussion earlier about binding width
  937.                               and formatted lines.
  938.  
  939.                               If the lines are not (F) formatted yet
  940.                               the (P) page breaks are present.  MegaD
  941.                               Spool will format the lines to current
  942.                               margins and create a new page with each
  943.                               page break.
  944.  
  945.                     E
  946.                               The E attribute stands for Escape
  947.                               sequences were found within the
  948.                               document. MegaD Spool comes to one quick
  949.                               conclusion once it finds (E) Escape
  950.                               sequences and that is, 'this is a fully
  951.                               formatted document,' and will send it
  952.                               straight to the printer.  If you are in
  953.                               "Reformat mode," MegaD Spool will remove
  954.                               all escape sequences and then reformat
  955.                               the document to the printer.
  956.  
  957.                     H
  958.                               The H attribute stands for HEX or
  959.                               hexadecimal.  Any file that is non-ASCII
  960.                               will be considered this type of file.
  961.                               If the file contains this type of
  962.                               information, MegaD Spool will print it
  963.                               as a HEX dump.  A HEX dump is very paper
  964.                               consuming, it takes 1 line to print 16
  965.                               characters.  So unless you are sure you
  966.                               want this type of a printed document,
  967.                               refrain from printing not-ASCII text
  968.                               files with MegaD Spool.
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.                    MegaD Spool 1.2 © Copyright 1993 John L. Jones
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.                                                     MegaD Spool Menu 16
  995.  
  996.  
  997.                                      v"zMegaD Spool Menuv"z
  998.                     The MegaD Spool menu is a very simple project
  999.                     menu.  It contains options for loading or saving
  1000.                     setting files and quitting MegaD Spool.
  1001.  
  1002.           v"zProject, Open...v"z
  1003.                     This will let you load a pre-saved setting file by
  1004.                     the standard Amiga file requestor.  The setting
  1005.                     file contains all setting attributes that were set
  1006.                     at the time the setting file was saved.  When
  1007.                     MegaD Spool is first started it looks for the
  1008.                     default setting file "mdSpool.spl" and if it finds
  1009.                     it will load and use this setting file information
  1010.                     to set the setting attributes.
  1011.  
  1012.           v"zProject, Savev"z
  1013.                     This will save the current settings to the last
  1014.                     loaded setting file.  If during this run, you have
  1015.                     not loaded or saved a setting file, the file will
  1016.                     be saved as the default "mdSpool.spl".  If you
  1017.                     have changed the current settings, MegaD Spool
  1018.                     will save it as that file.  It will always notify
  1019.                     you if you are going to delete a previous saved
  1020.                     file with a requestor and give you the option to
  1021.                     cancel that save.
  1022.  
  1023.           v"zProject, Save As...v"z
  1024.                     This will allow you to save the current settings
  1025.                     to any file name you wish by using the standard
  1026.                     Amiga file requestor. You should always append the
  1027.                     ".spl" extension to the end of the file name.
  1028.                     This way you will always be able to find and
  1029.                     recognize the settings files as one of MegaD Spool
  1030.                     settings files.  The file requestor uses the
  1031.                     "#?.spl" pattern matches to list the files, this
  1032.                     is another good argument to use the ".spl" name
  1033.                     extension.  The settings file also save the size
  1034.                     and location of the file requestor, this will
  1035.                     allow you to re-size and move the requestor to
  1036.                     your liking and it will be reopened to the same
  1037.                     size and locations.
  1038.  
  1039.           v"zProject, About...v"z
  1040.                     This will open a small requestor with information
  1041.                     about the author and the version of the program.
  1042.  
  1043.           v"zProject, Quitv"z
  1044.                     This will quit MegaD Spool.  It will warn you if
  1045.                     you have files printing and double check to see if
  1046.                     you want to Quit.  If there are no print jobs at
  1047.                     the moment it will quit without any requestor.
  1048.  
  1049.  
  1050.                    MegaD Spool 1.2 © Copyright 1993 John L. Jones
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.                                          MegaD Spool Icon tools type 17
  1061.  
  1062.  
  1063.                                v"zMegaD Spool Icon tools typev"z
  1064.  
  1065.           v"zMegaD Spool Icon tools types.v"z
  1066.                     MegaD Spool supports two tool types to be added to
  1067.                     the MegaD Spool Workbench tool icon.
  1068.  
  1069.           v"zCREATEICONS=NOv"z
  1070.                     This tells MegaD Spool to not to create setting
  1071.                     icons.  The default is to create icons for the
  1072.                     setting files.
  1073.  
  1074.           v"zPUBSCREEN=screen_namev"z
  1075.                     This tells MegaD Spool to open onto another screen
  1076.                     other than the Workbench screen.  If you want
  1077.                     MegaD Spool to open onto the MegaD public screen,
  1078.                     set the tool type to PUBSCREEN=MEGAD
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.                    MegaD Spool 1.2 © Copyright 1993 John L. Jones
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.                                           MegaD Spool ARexx commands 18
  1127.  
  1128.  
  1129.                                       v"zARexx commandsv"z
  1130.  
  1131.           A number of things are assumed in this document.
  1132.  
  1133.                     You are familiar with MDSpool and the functions
  1134.                     you wish to use within MDSpool through the ARexx
  1135.                     port.
  1136.  
  1137.                     You are familiar with the ARexx programing
  1138.                     language.
  1139.  
  1140.           v"zCase Sensitivityv"z
  1141.                     All commands and arguments are not case sensitive.
  1142.                     So the call "dbug true" and "DBUG TRUE" will be
  1143.                     interpreted the same.
  1144.  
  1145.  
  1146.           Format    The descriptions of the commands and with
  1147.                     arguments format follow these convections.
  1148.  
  1149.           <>        Angle brackets enclose arguments are arguments
  1150.                     that must be provided. For instance, <filename>
  1151.                     means that you must enter the appropriate file
  1152.                     name in that position.  Unless square brackets
  1153.                     surround the argument (see below), the argument is
  1154.                     required. The command will not work unless it is
  1155.                     specified.
  1156.  
  1157.           []        Square brackets enclose arguments and keywords
  1158.                     that are optional.  They will be accepted by the
  1159.                     command but are not required.
  1160.  
  1161.                     The following is an example:
  1162.                          VolPerScr [<value> <value>]
  1163.                     This translates to:
  1164.                     VolPerScr may be called without arguments, But if
  1165.                     arguments are supplied it requires two of them.
  1166.  
  1167.                     In this document, the ARexx command will be listed
  1168.                     to the far left of the text.  If any arguments are
  1169.                     used with the command they will be listed on the
  1170.                     next line to the far left of the text with
  1171.                     command.  The paragraph to the right of the
  1172.                     command describes the functions if it is unique to
  1173.                     to ARexx.
  1174.  
  1175.           Errors    Errors will set the RC code to 20.
  1176.  
  1177.           Returns   All commands that return a value, uses the result
  1178.                     variable.
  1179.  
  1180.  
  1181.  
  1182.                    MegaD Spool 1.2 © Copyright 1993 John L. Jones
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.                                           MegaD Spool ARexx commands 19
  1193.  
  1194.  
  1195.           v"zMDSpool ARexx Portv"z
  1196.                     The MDSpool ARexx port is titled MDSPOOL.1.  If
  1197.                     other MDSPOOL.x ports are found the ARexx port
  1198.                     name will be incremented to the next number .1,
  1199.                     .2, .3...
  1200.                     NOTE: It is not a good idea to have more than one
  1201.                     program competing for access to the printer.
  1202.  
  1203.                     All the ARexx commands that do the action of a
  1204.                     gadget are given the name of that gadget without
  1205.                     the spaces.
  1206.  
  1207.           ARexx function list
  1208.  
  1209.  
  1210.                     rexxOnly
  1211.                     clear
  1212.                     save
  1213.                     saveAs
  1214.                     open
  1215.                     stopCurrentJob
  1216.                     stopAllJobs
  1217.                     removeAllJobs
  1218.                     addJob
  1219.                     addJobDel
  1220.                     iconify
  1221.                     pitch
  1222.                     lineSpace
  1223.                     mode
  1224.                     pageWidth
  1225.                     leftMargin
  1226.                     rightMargin
  1227.                     tabWidth
  1228.                     bindingWidth
  1229.                     pageLength
  1230.                     topMargin
  1231.                     bottomMargin
  1232.                     printPath
  1233.                     printPageNumber
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.                    MegaD Spool 1.2 © Copyright 1993 John L. Jones
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.                                           MegaD Spool ARexx commands 20
  1259.  
  1260.  
  1261.           v"zrexxOnlyv"z
  1262.           rexxOnly <TRUE | FALSE>
  1263.                     TRUE
  1264.                     Will close all windows and the Application Icon
  1265.                     leaving the only means of communicating with
  1266.                     MDSpool through the ARexx port
  1267.                     FALSE
  1268.                     Will open the spool window if it is closed
  1269.  
  1270.           v"zclearv"z
  1271.                     Removes both current print job and pending jobs
  1272.            
  1273.           v"zsavev"z
  1274.           save [filename]
  1275.                     Saves defaults as last loaded file, if no filename
  1276.                     has been loaded or saved it will default to
  1277.                     "mdSpool.spl"
  1278.            
  1279.           v"zsaveAsv"z
  1280.           saveAs <filename>
  1281.                     Will save the settings to the file specified if no
  1282.                     filename is sent the settings will not be saved
  1283.  
  1284.           v"zopenv"z
  1285.           open [filename]
  1286.                     Will open the setting file, if no filename is sent
  1287.                     the default file "mdSpool.spl" will be loaded
  1288.  
  1289.           v"zstopCurrentJobv"z
  1290.                     Will abort the current print job going to the
  1291.                     printer
  1292.  
  1293.           v"zstopAllJobsv"z
  1294.                     Will remove all jobs pending and then stop the
  1295.                     current print job
  1296.  
  1297.           v"zremoveAllJobsv"z
  1298.                     Will remove all jobs pending to go to the printer.
  1299.                     It will not cancel the current print job
  1300.  
  1301.           v"zaddJobv"z
  1302.           addJob <filename>
  1303.                     Will add a file to the job list.  The filename
  1304.                     sent with this should be the complete path
  1305.  
  1306.           v"zaddJobDelv"z
  1307.           addJobDel <filename>
  1308.                     Will add a file to the job list.  The filename
  1309.                     sent with this should be the complete path.  THE
  1310.                     FILE WILL BE DELETED AFTER PRINTING!
  1311.  
  1312.  
  1313.  
  1314.                    MegaD Spool 1.2 © Copyright 1993 John L. Jones
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.                                           MegaD Spool ARexx commands 21
  1325.  
  1326.  
  1327.           v"ziconifyv"z
  1328.           iconify <TRUE | FALSE>
  1329.                     TRUE
  1330.                     Will iconify window if open and place icon on
  1331.                     workbench
  1332.                     FALSE
  1333.                     Will reopen window if in iconify mode
  1334.  
  1335.           v"zpitchv"z
  1336.           pitch <VALUE>
  1337.                     Sets one of four possible fonts or pitches with
  1338.                     the VALUE sent.
  1339.                     VALUEs
  1340.                          0 = Normal
  1341.                          1 = Elite
  1342.                          2 = Condensed
  1343.                          4 = NLQ
  1344.  
  1345.           v"zlinev"z
  1346.           line <VALUE>
  1347.                     Sets one of two possible line spacing
  1348.                     VALUEs
  1349.                          0 = 1/6" Lines Per Inch
  1350.                          1 = 1/8" Lines Per Inch
  1351.  
  1352.           v"zmodev"z
  1353.           mode <VALUE>
  1354.                     Sets one of three possible print modes
  1355.                     VALUEs
  1356.                          0 = Pass-through
  1357.                          1 = AI Mode
  1358.                          2 = Re-Format
  1359.  
  1360.           v"zpageWidthv"z
  1361.           pageWidth <VALUE>
  1362.                     Sets the page width of the settings.  The only
  1363.                     error checking is to prevent negative values,
  1364.                     incompatible values will not be checked.  It is up
  1365.                     to the ARexx program to send valid values for all
  1366.                     margins, widths and lengths.  Strange things will
  1367.                     happens if total margins and binding widths exceed
  1368.                     the page width or the page length!
  1369.  
  1370.           v"zleftMarginv"z
  1371.           leftMargin <VALUE>
  1372.                     Sets the left margin of the settings.
  1373.  
  1374.           v"zrightMarginv"z
  1375.           rightMargin <VALUE>
  1376.                     Sets the right margin of the settings.
  1377.  
  1378.  
  1379.  
  1380.                    MegaD Spool 1.2 © Copyright 1993 John L. Jones
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.                                           MegaD Spool ARexx commands 22
  1391.  
  1392.  
  1393.           v"ztabWidthv"z
  1394.           tabWidth <VALUE>
  1395.                     Set the tab width value for the settings
  1396.  
  1397.           v"zbindingWidthv"z
  1398.           bindingWidth <VALUE>
  1399.                     Sets the binding width for the settings.  The
  1400.                     binding width simply adds spaces to the start of
  1401.                     all lines.
  1402.  
  1403.           v"zpageLengthv"z
  1404.           pageLength <VALUE>
  1405.                     Sets the page length for the settings
  1406.  
  1407.           v"ztopMarginv"z
  1408.           topMargin <VALUE>
  1409.                     Sets the top margin for the settings
  1410.  
  1411.  
  1412.           v"zbottomMarginv"z
  1413.           bottomMargin <VALUE>
  1414.                     Sets the bottom margin for the settings
  1415.  
  1416.           v"zprintPathv"z
  1417.           printPath <VALUE>
  1418.                     Sets one of 3 possible values for Print Path of
  1419.                     Settings
  1420.                     VALUEs
  1421.                          0 = No Path
  1422.                          1 = Path In Heading
  1423.                          2 = Path In Footer
  1424.  
  1425.           v"zprintPageNumberv"z
  1426.           printPageNumber <VALUE>
  1427.                     Sets one of 7 possible values for Print Page
  1428.                     Number
  1429.                     VALUEs
  1430.                          0 = No Page Number
  1431.                          1 = Left hand Top of page
  1432.                          2 = Center Top of page
  1433.                          3 = Right hand Top of page
  1434.                          4 = Left hand bottom of page
  1435.                          5 = Center bottom of page
  1436.                          6 = Right hand bottom of page
  1437.  
  1438.           END OF TEXT
  1439.  
  1440.           END OF TEXT
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.                    MegaD Spool 1.2 © Copyright 1993 John L. Jones
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.                                                    MegaD Spool Index 23
  1457.  
  1458.  
  1459.                                         v"zIndexv"z
  1460.  
  1461.           Add Job  6-7, 9
  1462.           addJob  19-20
  1463.           addJobDel  19-20
  1464.           Application Window  6
  1465.           Binding Width  11, 14-15, 21-22
  1466.           bindingWidth  19, 22
  1467.           Bottom Margin  12, 14, 22
  1468.           bottomMargin  19, 22
  1469.           Calculating Text Width  11
  1470.           Case Sensitivity  18
  1471.           clear  19-20
  1472.           CREATEICONS=NO  17
  1473.           Current Job  6-7
  1474.           Iconify  6, 9, 19, 21
  1475.           Left Margin  10-11, 14, 21
  1476.           leftMargin  19, 21
  1477.           line  11-15, 18, 21
  1478.           Line spacing  11, 21
  1479.           MDSpool ARexx Port  19
  1480.           MegaD Spool Icon tools types.  17
  1481.           MegaD Spool Settings  1, 9-10, 16
  1482.           MegaD Spool Windows  6
  1483.           mode  2, 11-13, 15, 19, 21
  1484.           Mode, Pass Through  12
  1485.           Mode, Reformat  13
  1486.           Mode, Smart  13
  1487.           Modify Job  6-7
  1488.           open  2, 7-10, 16-17, 19-21
  1489.           Page Length  12, 21-22
  1490.           Page Width  10-11, 13-14, 21
  1491.           pageLength  19, 22
  1492.           pageWidth  19, 21
  1493.           Pause Print  6-7, 9
  1494.           pitch  10-11, 14, 19, 21
  1495.           Pitch settings  10
  1496.           Print Page Number  12, 22
  1497.           Print Path  12, 22
  1498.           printPageNumber  19, 22
  1499.           printPath  19, 22
  1500.           Project, About...  16
  1501.           Project, Open...  16
  1502.           Project, Quit  16
  1503.           Project, Save  16
  1504.           Project, Save As...  16
  1505.           PUBSCREEN=screen_name  17
  1506.           Remove All Jobs  7, 20
  1507.           Remove Selected Job  6-7
  1508.           removeAllJobs  19-20
  1509.           rexxOnly  19-20
  1510.  
  1511.  
  1512.                    MegaD Spool 1.2 © Copyright 1993 John L. Jones
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.                                                    MegaD Spool Index 24
  1523.  
  1524.  
  1525.           Right Margin  10-11, 21
  1526.           rightMargin  19, 21
  1527.           save  16, 19-20
  1528.           saveAs  19-20
  1529.           stopAllJobs  19-20
  1530.           stopCurrentJob  19-20
  1531.           Tab Width  11, 22
  1532.           tabWidth  19, 22
  1533.           Top Margin  12, 22
  1534.           topMargin  19, 22
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.                    MegaD Spool 1.2 © Copyright 1993 John L. Jones
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.